home *** CD-ROM | disk | FTP | other *** search
/ Amiga Inside! / Amiga FD Inside (1995)(Ultramax).iso / berndspd / devtools / lk / lk.readme < prev    next >
Text File  |  1994-11-01  |  10KB  |  284 lines
  1. Short:    The quicker linker for Amiga
  2. Type:     dev/misc
  3. Uploader: alexis@netcom.com
  4. Author:   alexis@netcom.com
  5.  
  6. lk currently is not a public domain production.
  7.  
  8. DO NOT FORGET THAT EACH USER MUST PURCHASE HIS OWN SAMPLE.
  9.  
  10. lk© is a copyright of Alexis WILKE (c) 1993-1994.
  11. (See below to know how you can purchase lk©)
  12.  
  13.                     Summary
  14.  
  15.     Requirements
  16.     Features
  17.     About lk linker production
  18.     How you can purchase lk
  19.     Order form
  20.     Credits
  21.  
  22.  
  23.                     Requirements
  24.  
  25. lk is supposedly working on any system, but a minimum
  26. might be required. There is a list of what I think
  27. of, which could make a difference:
  28.  
  29.   . 1MB or more of ram memory
  30.   . Amiga system V36+ (Enable the pattern in file names)
  31.   . Hard Drive (all lk files uses more than 2Mb)
  32.   . An assembler or compiler which generates object files
  33.  
  34.  
  35.                     Features
  36.          (See below for some definitions)
  37.  
  38.   . compatible to dlink of DICE
  39.   . compatible to alink
  40.   . compatible to blink
  41.   . compatible to slink (support bugs as well)
  42.   . compatible to most linkers
  43.  
  44.   . documentation available in english and french
  45.     (the demo version has only the english version)
  46.  
  47.  Note: its compatible except for speed, lk is up to 5.5 faster
  48. than Slink V6.xx when used with QuickDOS© library. This is
  49. valuable only on big files, but isn't that which matter?
  50.  
  51.   . supports executable as source files
  52.   . supports AmigaDOS wild cards and multiple assigns
  53.   . supports V40 hunks and advisory bit
  54.   . supports archived object libraries
  55.   . supports easy to use memory management
  56.   . supports small and single instructions
  57.   . supports a CODE/DATA to BSS transformation
  58.   . supports truncated CODE/DATA hunks auto-cleared or not
  59.   . supports the V37 reloc32short bug (R/W)
  60.   . supports a complete documentation (English and Française)
  61.   . supports a non-limited number of define
  62.   . supports some kind of invalid hunks
  63.   . supports a reference table
  64.   . supports an ORG function to create ROMs, games, Unix codes
  65.   . supports PC relative over 32768 (ALV)
  66.   . supports a library creation mode ('Pre-Link')
  67.   . supports external symbol creation with defines
  68.   . supports a symbol and a debug deletion command
  69.   . supports Amiga .library executable creation
  70.   . supports odd relocations (68020+ only)
  71.   . supports a pure command
  72.   . supports CODE/DATA/BSS as three distinct hunk types
  73.   . supports each memory requirement as a hunk distinction
  74.   . supports a user definition of the relative OFFSET (near data)
  75.   . supports 5 different path lists
  76.   . supports two modes of automatic initialisations
  77.   . supports C libraries having symbol defined several times
  78.   . supports WITH file (script files of lk commands)
  79.   . supports a preference setting and auto-WITH files
  80.   . supports modern overlays (save regs and no useless tree)
  81.   . supports automatic source file recognition
  82.   . supports '.fd' file definitions for libraries
  83.   . supports icons and can start from the WorkBench
  84.   . supports a fast object loading library (QuickDOS.library)
  85.   . supports a WorkBench compatible interface to create WITH files
  86.   . supports various automation for your executables
  87.       (auto detach, fix stack size, fix priority, ...)
  88.  
  89.  
  90.  
  91.  
  92.                  About lk linker production
  93.  
  94. lk© was created to be able to link IE (My Intuition Editor.)
  95. I used BLink before, but that old linker crashed after a
  96. to large amount of labels. Actually IE© needs not less
  97. than 101Kb of memory for symbols in 778 hunks generating
  98. 4861 references... and the executable file is 668704 bytes!
  99.  
  100. When I was using BLink, the instruction SMALLDATA was of
  101. course useful. But that function was creating a huge data
  102. hunk and putting it in CHIP when at least one of my hunks
  103. has the CHIP memory flag requirement. This is absolutly
  104. not the same with lk. lk will generate two hunks, one
  105. in public memory and one in chip (Note: the BLink option
  106. is supported.)
  107.  
  108. Another point is: BLink changed BSS hunks into DATA hunks
  109. when you used SMALLDATA, making the DATA hunk huger than
  110. ever. lk© never transforms a BSS except in some very
  111. particular cases. Here the BLink option is no more
  112. supported.
  113.  
  114.  
  115.                   How you can purchase lk©
  116.  
  117.   lk© is a shareware. lk© will never be a freeware or any
  118.   other kind of public domain program. This linker is
  119.   protected by the law of the Author copyright.
  120.   The version of lk© which displays:
  121.  
  122.         VERSION DEMO OF LK© PROGRAM
  123.         THANK YOU TO REGISTER YOU AT
  124.              Alexis WILKE
  125.              1525, SW Park Avenue, #B304
  126.              Portland, OR 97201
  127.              U.S.A.
  128.              Phone (503) 248 5607
  129.         IT IS ONLY U.S. $15.00
  130.         ARE YOU OK TO REGISTER YOU  ?
  131.  
  132.   can be copied to anyone with the entire archive file
  133.   which must be unaltered. Any other version is a registred
  134.   version and copy it is against the law of the Author
  135.   copyright.
  136.  
  137.   The complete version must be bought by EACH user to the
  138.   author Alexis WILKE at:
  139.  
  140.                   Alexis WILKE
  141.                   1525, SW Park Avenue, #B304
  142.                   Portland, OR 97201
  143.                   U.S.A
  144.                   Phone: (503) 248 5607
  145.  
  146.                   or
  147.  
  148.                   Alexis WILKE
  149.                   3, rue du docteur Tuefferd
  150.                   25200 Montbéliard
  151.                   FRANCE
  152.                   No phone.
  153.  
  154.   lk© disk includes:
  155.  
  156.        lkopts   a Workbench interface to edit options (WITH files)
  157.        make    a simple file maker
  158.        lsobj    an object lister
  159.        AHelp®    a help file viewer (With a search command)
  160.        xx.hlp    a large list of help file
  161.        xx.info    nice icons
  162.  
  163.   To order you can copy and fill the following form and
  164.   send it accompanied with your payment:
  165.  
  166. ---- CUT FROM HERE ----
  167.  
  168.  
  169.                  lk Linker (c) 1993-1994            OF2
  170.                         Order Form
  171.  
  172.     I desire to receive a copy of the registered version of lk©.
  173.     This version includes the linker, a complete documentation
  174.     using AHelp©, and some useful utilities for development.
  175.     I agree to keep the orinal disks as a proof of my purchase
  176.     and I understand that it is forbidden to make a copy of any
  177.     material from lk disks for anyone else.
  178.  
  179.  
  180.     (Please print in capital)
  181.  
  182.     Company:   ........................................................
  183.  
  184.     User Name: ........................................................
  185.  
  186.     Address:   ........................................................
  187.     City:      ........................................................
  188.     State:     ..........   Zip: ......................................
  189.     Country:   ........................................................
  190.  
  191.     Phone:     ................   Work Phone: .........................
  192.  
  193.     EMail:     ........................................................
  194.  
  195.     (If you want to let us know about your projects)
  196.     Projects:  ........................................................
  197.                ........................................................
  198.                ........................................................
  199.                ........................................................
  200.                ........................................................
  201.                ........................................................
  202.                ........................................................
  203.                ........................................................
  204.                ........................................................
  205.  
  206.  
  207.                                                Name:
  208.                                                Signature:
  209.                                          (Very important)
  210.  
  211.  
  212.  
  213.     Designation         Unit Price      Quantity      Total
  214.  
  215.     lk© linker ......... US $15.00        _____      _____
  216.  
  217.  
  218.  
  219.     Payable to the order of "Alexis WILKE" with a US check or US money
  220.     order, an EuroCheck or French Check. You will receive a Bill with
  221.     your product.
  222.  
  223.     Only US dollars and French Francs are accepted.
  224.  
  225.     The unit price of lk© in French Francs is FF90,00.
  226.     The unit price of AHelp© in French Francs is FF60,00.
  227.  
  228.     From any other country you must change your money.
  229.     If you decide to send a check of any kind add US $15.00 of
  230.     bank fee (FF90,00).
  231.     Money sent via "money-gram®" of AmericanExpress® does not
  232.     include additionnal fees.
  233.  
  234.     Only orders accompanied by payment are processed.
  235.  
  236.  
  237.  
  238.                                                     OF2
  239.  
  240.  
  241. ---- CUT TO THERE ----
  242.  
  243.  
  244.   Note: If you let me an E-Mail I will send some user comments, a
  245.   list of the new improvements, new script, etc...
  246.  
  247.  
  248.  
  249.              Credits
  250.  
  251.   Programming           Alexis WILKE
  252.  
  253.   Assembler             BAsm© V1.99 & DevPac© V2.00
  254.   Linker                lk©
  255.   Text Editor           CygnusEd© V2.12
  256.   Icons                 Alexis WILKE & Patrik Lundquist
  257.   Documentation         Alexis WILKE & Patrik Lundquist
  258.  
  259.  
  260.      And a special thanks to the following
  261.      people which helped me to provide the
  262.      last touches to lk:
  263.  
  264.   Michael van Elst
  265.   Patrik Lundquist
  266.   Ralph Schmidt
  267.  
  268.  
  269.  
  270. lk© is a copyright of Alexis WILKE. All rights reserved.
  271. lkopts© is a copyright of Alexis WILKE. All rights reserved.
  272. lsobj© is a copyright of Alexis WILKE. All rights reserved.
  273. IE© is a copyright of Alexis WILKE. All rights reserved.
  274. AHelp© is a copyright of Alexis WILKE. All rights reserved.
  275. Commodore® is a registered trade mark of Commodore Business Machines.
  276. Amiga® is a registered trade mark of Commodore Business Machines.
  277. DevPac© is a copyright of HiSoft. All rights reserved.
  278. BAsm© is a copyright of Ralph Schmidt. All rights reserved.
  279. CynusEd© is a copyright of CynusSoft Software. All rights reserved.
  280. DICE© is a copyright of Matthew Dillon. All rights reserved.
  281. Blink© is a copyright of (1986) The Software Distillery and
  282.                          (1987) SAS Institute Inc. All rights reserved.
  283. Slink© is a copyright of SAS Institute Inc. All rights reserved.
  284.